home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILECOPY / COPYIT.ZIP / COPYIT.DOC < prev    next >
Encoding:
Text File  |  1990-01-12  |  46.8 KB  |  1,290 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                         COPYIT
  30.                                         ------
  31.  
  32.                                      Version 2.10
  33.                                    January 12, 1990
  34.  
  35.                                   File Copy Utility
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                      Written by:
  45.                                    Frank J. Condron
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                    Contech Systems
  58.                                     P.O. Box 87542
  59.                                    Canton, MI 48188
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.           INTRODUCTION
  76.           ------------
  77.  
  78.                COPYIT is a file copy utility designed to give you much more
  79.           control  over your copy operations than the  DOS  COPY  or  XCOPY
  80.           commands.  Features include:
  81.  
  82.               *  COPYIT will prompt you to insert another diskette when the
  83.                  current diskette is  full,  allowing  you  to  easily copy
  84.                  large subdirectories of files,
  85.  
  86.               *  A built-in  optimization  system,  to  fill  diskettes  as
  87.                  completely as possible,
  88.  
  89.               *  Break and  Restore  commands,  to  split  huge  files over
  90.                  multiple diskettes,
  91.  
  92.               *  Enhanced  memory  usage; all available  system  memory  is
  93.                  utilized for buffering,  resulting in faster operation and
  94.                  fewer diskette swaps,
  95.  
  96.               *  Subdirectory copy - COPYIT 2.10 can duplicate  a directory
  97.                  structure on the target  disk,  or  copy  all of the files
  98.                  from a directory structure to the same target directory if
  99.                  desired,
  100.  
  101.               *  A True  Verify  parameter  that  assures  files  have been
  102.                  copied correctly through the use of a 32 bit CRC system,
  103.  
  104.               *  COPYIT can prompt you before copying each file, giving you
  105.                  greater control over what files are copied,
  106.  
  107.               *  COPYIT can check to make sure no files will be overlaid,
  108.  
  109.               *  An intelligent move parameter, to  move  files  instead of
  110.                  simply copying them,
  111.  
  112.               *  COPYIT can copy files based on date or  size  criteria, or
  113.                  that are hidden or system files
  114.  
  115.               *  Copy files based on the archive bit, and reset that bit if
  116.                  desired,
  117.  
  118.               *  Exclude files from being copied by using the familiar mask
  119.                  format,
  120.  
  121.           Copyright   (c)   1988-1990   Contech  Systems,  all  rights
  122.           reserved.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                         - 2 -
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.           REGISTRATION
  143.           ------------
  144.  
  145.                COPYIT is  distributed  and  marketed  under  the  Shareware
  146.           concept.    Shareware  is  a  system that allows you to  evaluate
  147.           software to see if it fills your needs BEFORE  you  purchase  it.
  148.           You may freely distribute copies of  COPYIT,  as long as it is in
  149.           the original, unmodified form.  It may not,  however,  be bundled
  150.           with  other  software  packages  without prior written permission
  151.           from Contech Systems.
  152.                Under the shareware system, you may freely use COPYIT for an
  153.           evaluation  period not to exceed thirty days.   If  you  find  it
  154.           useful  and  continue  to use it after the evaluation period, you
  155.           are  required  to  pay  a  registration  fee  of  $15.       Your
  156.           registration  entitles you to product  support,  future upgrades,
  157.           and discounts on  other  Contech  System  products.  To register,
  158.           simply print and complete  the  registration  form  included with
  159.           COPYIT (in  the file REGISTER.FRM), enclose check or money orders
  160.           payable to Contech Systems, and send to:
  161.  
  162.                         Contech Systems
  163.                         P.O. Box 87542
  164.                         Canton, MI 48188
  165.  
  166.                         ATTN: COPYIT Registration
  167.  
  168.                If you have any problems in executing COPYIT, please contact
  169.           us at the above  address.   Although we cannot offer full product
  170.           support unless  registered,  we  also  cannot  expect  someone to
  171.           register if they cannot get the program to work at all!
  172.  
  173.  
  174.  
  175.           DISCLAIMER
  176.           ----------
  177.  
  178.                Under   no  circumstances  shall  Contech  Systems  or   its
  179.           suppliers be liable for any damages whatsoever, including but not
  180.           limited to loss  of  business  profits  or  information, business
  181.           interruption,  or  any  other loss arising  out  of  the  use  or
  182.           inability to use this software product.
  183.  
  184.  
  185.           COPYIT Operation
  186.           ----------------
  187.  
  188.                COPYIT  is  very  easy to use.  If you are familiar with the
  189.           standard  DOS COPY command, you can already  use  COPYIT  in  its
  190.           place for standard copy  operations.    To  take advantage of the
  191.           special features of COPYIT,  it  is  necessary to become familiar
  192.           with various parameters which will be described later.
  193.                COPYIT  commands are entered from the  DOS  prompt,  in  the
  194.           following format:
  195.  
  196.  
  197.  
  198.  
  199.                                         - 3 -
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.             COPYIT [copyfrompath\mask] [Copytopath\mask] [/p1../pn]
  210.  
  211.           Copyfrompath\mask is the drive, path,  and mask for the files you
  212.           want to copy.   Copytopath\mask  is the drive, path, and mask you
  213.           want  the  files  copied  to,  and  [/p1../pn]  are  the  command
  214.           parameters, each beginning with a '/', and separated by a space.
  215.                Masks are entered in the  identical  format  that  DOS uses,
  216.           including wildcards.  Specifying a  copyto  mask  will  result in
  217.           files being renamed as they are copied.  For example, if
  218.  
  219.                    COPYIT a:*.* c:?Z*.new
  220.  
  221.           were entered, the result  would  be that all files in the current
  222.           directory on disk A  would  be copied to the current directory on
  223.           drive  C, and the files would be renamed.  The new names would be
  224.           the same as they originally were, except that  the  second letter
  225.           in each name would  become  'Z'  and  the extensions would become
  226.           .NEW .  For example, a file named APPLES.BAK would be copied to a
  227.           file  named  AZPLES.NEW.   Refer to  your  DOS  manual  for  more
  228.           information on masks and wildcards.
  229.                If no copyfrom mask is  specified,  COPYIT  will  target all
  230.           files in the  specified  subdirectory.    If  no  copyto  mask is
  231.           entered, COPYIT assumes you wish to copy the files to the current
  232.           drive/directory.
  233.                Parameters  (discussed  below)  are  entered after the above
  234.           path\mask indicators.  Parameters must  be  preceded  by  a slash
  235.           (/), and each must be separated by a space.
  236.  
  237.  
  238.           Copying Many Files
  239.           ------------------
  240.  
  241.                Many times it is necessary to copy a number of files  from a
  242.           large subdirectory on  a  hard  disk  to  diskettes.    Using the
  243.           standard DOS copy commands, this  is  virtually  impossible  - as
  244.           soon  as the first diskette is out of  space,  the  copy  command
  245.           aborts.  Typing the individual  file  names  is  inconvenient and
  246.           time consuming; altering the  archive  bit  is undesirable if you
  247.           make backups.  COPYIT solves  this problem.  Whenever the current
  248.           diskette is out of space, COPYIT will prompt you to insert  a new
  249.           one.  COPYIT will then continue where it left off.  This function
  250.           is always active; you do not need to specify  any  parameters  to
  251.           use it.  If you do not have another diskette available, or do not
  252.           want to spread the copy between multiple diskettes, you may press
  253.           ESC at the prompt for another diskette - this will halt  the copy
  254.           operation.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                         - 4 -
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.           Built-In Optimization
  277.           ---------------------
  278.  
  279.                During diskette copy operations  that  will  be  spread over
  280.           many diskettes, it is not always very efficient to copy the files
  281.           in the exact order they appear.  For example,  if  the  directory
  282.           listed (in this order)  three  files  of  sizes 75000, 10000, and
  283.           18000 bytes, DOS COPY would copy them in  that  order.    You may
  284.           have already copied many files to a diskette, and only have 45000
  285.           bytes  free.    If you tried to  copy  the  above  files  to  the
  286.           diskette, DOS COPY would eventually realize the first file is too
  287.           big  for  the  remaining space and would abort.  COPYIT, however,
  288.           would copy the files to  the diskette in whatever order necessary
  289.           to  fit  as  many files on the diskette as possible; it will then
  290.           prompt you for another diskette.  Thus, the 10000 byte file would
  291.           be copied, then the 18000  byte  file.    Since  no  more  of the
  292.           remaining  files  (the  75000 byte one) will fit on the diskette,
  293.           you would then be prompted to insert another.
  294.  
  295.  
  296.           Enhanced Memory Usage
  297.           ---------------------
  298.                COPYIT now makes use of  more system memory for buffering to
  299.           speed copy operations and reduce  the  number  of  diskette swaps
  300.           that need to be performed.      The  actual  amount  used  can be
  301.           controlled through the  use  of parameters, if necessary (see the
  302.           /f parameter, below).
  303.  
  304.  
  305.           Aborting a File Copy
  306.           --------------------
  307.  
  308.                Pressing  the escape key (ESC) at any  time  during  a  copy
  309.           operation  will halt it.  Under  most  circumstances  this  takes
  310.           place immediately, but may take a few seconds  depending  on what
  311.           internal operations that COPYIT is performing.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                         - 5 -
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.           Break and Restore Commands
  344.           --------------------------
  345.  
  346.                Have you ever needed to give a friend or co-worker a copy of
  347.           a file, only to find it is too large to fit on a single diskette?
  348.           Using COPYIT, you can break the file over multiple diskettes, and
  349.           later use the Restore command to return the file to  its original
  350.           condition.
  351.  
  352.           Breaking Files
  353.  
  354.                To break  large files over many diskettes, simply use COPYIT
  355.           as you would for any copy operation, but add the  '/b' parameter.
  356.           This tells COPYIT that it should plan on copying  any  files  too
  357.           large  for  a  single  diskette  onto  more  that  one.  The '/b'
  358.           parameter  is  not  even really necessary - if the copy path/mask
  359.           entered includes a file that is too large for a  single diskette,
  360.           COPYIT  will warn you and prompt you for  whether  it  should  be
  361.           broken  over  many  diskettes  or  not.  Things to remember  when
  362.           breaking files:
  363.  
  364.               -  For obvious reasons, COPYIT cannot  break  files  when the
  365.                  target is a hard drive
  366.  
  367.               -  COPYIT always processes files being broken last
  368.  
  369.               -  The diskettes that the file  is being broken onto need not
  370.                  be empty, but COPYIT will not split a file onto a diskette
  371.                  that has less then 4K (4096 bytes) of free disk space
  372.  
  373.           Each diskette that COPYIT uses will contain what  is  referred to
  374.           as a "portion file."  Each portion file is named as follows:
  375.  
  376.                         <primaryname>._NN
  377.  
  378.           As shown  above,  the  portion  files  are  named the same as the
  379.           original  filename,  but  have  a COPYIT-generated extension (the
  380.           part after the period).  This extension consists of an underscore
  381.           (_), and  a  number  ranging  from  01  to 99, referring to which
  382.           portion file it is.  The first eighty bytes of each  portion file
  383.           contains information that COPYIT uses to restore the file.
  384.  
  385.           Restoring Files
  386.  
  387.                When restoring  files  that  have  been  previously  broken,
  388.           COPYIT  operates  in  a much more rigid fashion than when copying
  389.           files or splitting them.  When restoring a file, the basic format
  390.           for COPYIT execution is the  same,  except  for  two differences.
  391.           First, no copyfrom mask is allowed - the path  and  primary  name
  392.           (the part before the  period)  must  be  explicitly entered.  The
  393.           second difference is  that  the  '/r'  parameter is added.   When
  394.           this parameter is specified, COPYIT enters Restore Mode.  When in
  395.           Restore Mode, all other parameters are ignored.
  396.  
  397.  
  398.  
  399.  
  400.                                         - 6 -
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.           Things to remember when restoring files:
  411.  
  412.               -  COPYIT will only restore one file per execution
  413.  
  414.               -  The file will  be  restored to it's original filename (the
  415.                  name  it  had  BEFORE it was broken), unless a copyto mask
  416.                  has been specified
  417.  
  418.               -  Files can only be  restored  to a hard drive.  The portion
  419.                  files used in the restore can be on diskettes or on a hard
  420.                  disk.
  421.  
  422.           See the examples at the end of this documentation for reference.
  423.  
  424.  
  425.           Log Files
  426.           ---------
  427.  
  428.                COPYIT  2.10 has added support for log  files.    Log  files
  429.           contain detailed information about COPYIT operations that you can
  430.           use later to review what has taken place.   Information  such  as
  431.           date  and  time  executed,  parameters,  files  copied  and their
  432.           destinations, error messages, reasons  why  files  were bypassed,
  433.           and more is included  in  the logfile.  For more information, see
  434.           '/L - Log Files' below.
  435.  
  436.  
  437.           Environment Variables
  438.           ---------------------
  439.  
  440.                COPYIT 2.10  now has support for environment variables.  The
  441.           "environment" is a  reserved  area in memory for information that
  442.           is accessible by  any  program.    It  is a useful place to store
  443.           small pieces of information that often-run programs use.
  444.                The environment area consists of variables of the form:
  445.  
  446.                  <variable name>=<data>
  447.  
  448.           These variables are created/altered  through  the  use of the SET
  449.           command.    If  you type SET  with  no  parameters,  all  of  the
  450.           environment variables are listed  out.   If you try this now, you
  451.           should see at  least  one environment variable; COMSPEC.  COMSPEC
  452.           is  a  variable used by DOS to keep track of where  to  find  the
  453.           program COMMAND.COM.
  454.                To add or change environment variables, enter:
  455.  
  456.                  SET <variable name> = <data>
  457.  
  458.           COPYIT  utilizes   environment   variables   to   hold  parameter
  459.           information that you often, or always, wish to  have  COPYIT use.
  460.           For example,  if you almost always enter the parameters '/z:5000-
  461.           /p  /m'  you  may get tired typing this many times.  Instead, you
  462.           could create  an environment variable to hold this information by
  463.           doing the following:
  464.  
  465.  
  466.  
  467.                                         - 7 -
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.                  SET MYPARM=/z:5000- /p /m
  478.  
  479.           You  can either type this in at the DOS prompt, or enter it as  a
  480.           line in your  AUTOEXEC.BAT  file  so  it will always exist in the
  481.           environment.  Then, when you wish to use these parms with COPYIT,
  482.           simply add the following parameter when you execute COPYIT:
  483.  
  484.                 /e:myparm
  485.  
  486.           The  '/e:'  is  described  below  in  the  parameter  description
  487.           section.  More  than  one  environment  variable can be used at a
  488.           time, subject to the following rules:
  489.  
  490.               -  When  duplicate  parameters  are entered, COPYIT processes
  491.                  the first it finds, and ignores the duplicates.
  492.  
  493.               -  COPYIT processes  entries on the command line (i.e. not in
  494.                  environment variables) before it processes the environment
  495.                  variables.
  496.                  The environment variables are then processed in  the order
  497.                  they have been entered when COPYIT was executed.
  498.  
  499.  
  500.                COPYIT uses  two  special,  optional  environment variables,
  501.           'COPYIT' and 'COPYLOG.'  Their uses are as follows:
  502.  
  503.                COPYIT:  If this environment  variable  exists,  COPYIT will
  504.           automatically use it whenever it is executed.  You do not need to
  505.           enter  '/e:copyit'  to  utilize  it.    This  variable is  always
  506.           processed  after  the  command  line  and  all  other environment
  507.           variables.
  508.  
  509.                COPYLOG: This variable tells COPYIT what file to  use  for a
  510.           log file (see the section on logfiles above).   It  is  processed
  511.           differently  than described in the rules  above;  if  it  exists,
  512.           COPYIT will  immediately  use  it  to  open  a logfile.  This has
  513.           advantages over using  the  '/l'  parameter  described  earlier -
  514.           since  the  logfile  is opened before any  other  parameters  are
  515.           processed, you  can be sure that any parameter error descriptions
  516.           will be included in the logfile.  Also, if you always wish to use
  517.           a logfile, this  variable  saves you from repetitiously typing in
  518.           the '/l'  parameter, or entering it into the 'COPYIT' environment
  519.           variable.    The  format for the  data  portion  of  the  COPYLOG
  520.           variable is the same as for the '/l'  parameter  described above,
  521.           although  you  may  optionally  leave  off the '/l:'  before  the
  522.           filename.
  523.                For more information on the environment and the SET command,
  524.           please refer to your DOS manual.
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.                                         - 8 -
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.           Parameters
  545.           ----------
  546.  
  547.                Parameters are the heart of COPYIT.  If you don't  use them,
  548.           the main thing you gain over  the  DOS COPY command is the prompt
  549.           for  inserting another target diskette if  there  is  not  enough
  550.           space to copy everything  specified,  and  the  built-in diskette
  551.           optimization.
  552.             /a - copy based on file archive bit.
  553.             /b - break large files over multiple diskettes
  554.             /c - check for overlay before copying.
  555.             /d - copy based on file date.
  556.             /e - utilize environment variables (registered version only)
  557.             /f - limit number of 4K buffers allocated
  558.             /h - copy Hidden files.
  559.             /l - keep detailed log file of copy operation.
  560.             /m - move files.
  561.             /p - prompt as to whether a file should be copied.
  562.             /q - quiet operation; suppress all beeps
  563.             /r - restore files split over multiple diskettes
  564.             /s - copy child subdirectories also
  565.             /sys - copy System files.
  566.             /t - place current date and time on copied files.
  567.             /oa  -  assign  copied files the same attribute as the original
  568.           files.
  569.             /v - perform DOS Verify while copying.
  570.             /vt - perform 32 bit CRC True Verification while copying.
  571.             /x - exclude files from the copy operation.
  572.             /z - copy based on file size.
  573.             /# - show copy operation information before executing
  574.             /^ - scroll prompt and overlay files
  575.             /@ - reset archive bit on files copied.
  576.  
  577.           You can see this summary at  any  time by entering COPYIT with no
  578.           other parameters from the DOS prompt.
  579.  
  580.                Parameters  may be entered in any order,  as  long  as  they
  581.           follow the copyfrom and copyto (if any) path/masks.  If  you make
  582.           any errors  in  entering  parameters,  COPYIT  will  respond with
  583.           messages describing what is wrong.   If COPYIT detects any errors
  584.           with input parameters, NO copying will take place.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.                                         - 9 -
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.           Parameter Definitions:
  612.           ----------------------
  613.           /A - Copy Based on Archive Bit :
  614.  
  615.                          Format: /a[+-]
  616.                          Use:   Whenever a file is created or modified, DOS
  617.                          turns  on  an indicator called  the  archive  bit.
  618.                          Backup programs normally reset this bit so that it
  619.                          is easy to determine what files have changed since
  620.                          the  last  backup.  COPYIT  normally  ignores  the
  621.                          archive bit, copying the  file  regardless  of its
  622.                          setting.  With the /a parameter, however,  you can
  623.                          perform  copies   based   on   the   archive  bit.
  624.                          Specifying  a  plus  (+)  sign after the parameter
  625.                          tells COPYIT to  only  copy  files  that  have the
  626.                          archive bit set (or turned on, indicating the file
  627.                          has been created or modified).  Specifying a minus
  628.                          (-) does the opposite; COPYIT will only copy files
  629.                          that have an archive bit that is off.
  630.                          SEE ALSO: Reset Archive Bit Parameter below (/@)
  631.  
  632.  
  633.           /B - Break Files :
  634.  
  635.                          Format: /b
  636.                          Use:    This  parameter  instructs COPYIT to break
  637.                          large files that  cannot fit onto single diskettes
  638.                          over many.  See the  section  "Break  and Restore"
  639.                          above.
  640.                          SEE ALSO: Restore Parameter below (/r)
  641.  
  642.  
  643.           /C - Check for Overlay :
  644.  
  645.                          Format: /c or /c-
  646.                          Use:  Normally, COPYIT operates much like  the DOS
  647.                          COPY  command when copying a file  to  a  disk  or
  648.                          subdirectory where an  identical  filename exists;
  649.                          it overwrites the old file.  If you  are  not sure
  650.                          what exists in the drive or subdirectory  that you
  651.                          are copying to, or if you just want  to  know what
  652.                          is  being  overlaid,  specify  the  /c  parameter.
  653.                          COPYIT  will  then  check  if a duplicate filename
  654.                          exists before copying  the  file.  If it does, you
  655.                          will be prompted as to  whether  or  not  the file
  656.                          should be overlaid.
  657.                               The   /c-  command  operates  in  a   similar
  658.                          fashion, except that COPYIT will not prompt you as
  659.                          to whether or  not  the file in question should be
  660.                          overlaid -  COPYIT  assumes  you  do  NOT  want to
  661.                          overlay the file.
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.                                        - 10 -
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.           /D - Copy based on File Date :
  679.  
  680.                          Format: /d:[date][+-]
  681.                          Use:  This parameter causes COPYIT to select files
  682.                          for copying  based  upon  the  date  the  file was
  683.                          created or last modified.    After  the  '/d:' the
  684.                          date you wish to test against  should  be entered.
  685.                          Immediately  after  the  date,  either a plus (+),
  686.                          indicating all files with dates equal to  or later
  687.                          than the test date, or a minus (-), indicating all
  688.                          files with dates equal to or before the test date,
  689.                          must be entered.
  690.                               The date  may  be  entered  with  or  without
  691.                          leading zeros.  Slashes, or any other non-numeric,
  692.                          non-space  character my be substituted for  dashes
  693.                          in the date.  For  example, to copy all files with
  694.                          dates  of August 9, 1988, or  later,  all  of  the
  695.                          following are valid:
  696.  
  697.                                         /d:08-09-88+
  698.                                         /d:8/9/88+
  699.                                         /d:08/9-88+
  700.  
  701.                          Similarly,  to copy all files created/modified  on
  702.                          or after November 1, 1988, enter:
  703.  
  704.                                         /d:11.1.88-
  705.                                     or  /d:11-01-88-
  706.                                     or  /d:11/1/88-
  707.  
  708.  
  709.           /E - Environment Variables :
  710.  
  711.                          Format: /e:<variable name>
  712.                          Use:  The /e parameter tells copyit to process the
  713.                          data  contained  within the  environment  variable
  714.                          <variable name> as if it  had been typed in on the
  715.                          command line when  COPYIT  was executed.   See the
  716.                          section 'Environment Variables,' above.
  717.  
  718.  
  719.           /F - Limit Buffers :
  720.  
  721.                          Format: /f:nn
  722.                          Use:  This parameter  tells  COPYIT  to  limit the
  723.                          number of 4K buffers allocated to nn (any positive
  724.                          integer).  If this parameter is  not  used, COPYIT
  725.                          allocates as many buffers  as  possible.    If for
  726.                          some reason you find  you  need  to limit how much
  727.                          RAM COPYIT uses, this parameter is available.
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                                        - 11 -
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.           /H - Hidden Files :
  746.  
  747.                          Format: /h
  748.                          Use:  Through DOS, a file can be marked as hidden.
  749.                          Such a  file is not shown when a directory command
  750.                          is given.  COPYIT normally ignores such files, but
  751.                          will include them in the  copy  operation  if this
  752.                          parameter is specified.
  753.                          SEE ALSO: Copy System File Parameter (/sys)
  754.  
  755.  
  756.           /L - Log Files :
  757.  
  758.                          Format: /l:<filename>[+]
  759.                          Use:    When  this  parameter is specified, COPYIT
  760.                          opens and uses a log file, as described in the Log
  761.                          File section above.  <filename> can  be  any valid
  762.                          path/filename  combination.    If  a plus sign (+)
  763.                          follows  the filename, COPYIT will append the  new
  764.                          information to the  end  of the file if it exists;
  765.                          if it does not  exist,  then  the file is created.
  766.                          If no plus sign follows the filename,  COPYIT will
  767.                          create  a  new  file,  deleting  any  old  logfile
  768.                          information.
  769.                          SEE ALSO: Environment Variables Section, above.
  770.  
  771.  
  772.           /M - Move Files :
  773.  
  774.                          Format: /m
  775.                          Use:  This parameter causes the files to be moved.
  776.                          If moving from one  disk  to  another, the file is
  777.                          first copied, then the original  is  deleted.   If
  778.                          the file is  being moved between subdirectories on
  779.                          the  same disk, it is simply  renamed.    If  True
  780.                          Verification (/vt, see description) is  active and
  781.                          a file fails  verification, the original file will
  782.                          NOT be deleted.
  783.  
  784.  
  785.           /OA - Original Attribute :
  786.                          Format: /oa
  787.                          Use:    Normally,  COPYIT  assigns   the  standard
  788.                          attribute value  of  32  to  copied  files.   This
  789.                          indicates that  the file is a normal file that has
  790.                          recently been changed.   If  you  wish  the copied
  791.                          files to have the  exact  same  attributes  as the
  792.                          original files (i.e.  Hidden,  System, Read-Only),
  793.                          specify  this  command.    For more information on
  794.                          attributes, please consult your DOS manual.
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.                                        - 12 -
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.           /P - Prompt :
  813.  
  814.                          Format: /p
  815.                          Use: When this parameter is specified, COPYIT will
  816.                          prompt you as to whether or not the file should be
  817.                          copied.  You will  not  be  prompted for any files
  818.                          that fail other selection criteria.
  819.  
  820.  
  821.  
  822.  
  823.           /Q - Quiet Operation :
  824.  
  825.                          Format: /q
  826.                          Use:  Normally, COPYIT  issues  beeps  to indicate
  827.                          that  some  action  is  needed (diskette swaps and
  828.                          other prompts).  If you  do not wish to hear these
  829.                          beeps, this parameter will silence them.
  830.  
  831.  
  832.           /R - Restore Files :
  833.  
  834.                          Format: /r
  835.                          Use:    Specifying  this  tells  COPYIT  to  enter
  836.                          Restore Mode to restore  a  file  broken  with the
  837.                          '/b' parameter.   All other parameters are ignored
  838.                          while in Restore Mode.  See the section "Break and
  839.                          Restore" above.
  840.                          SEE ALSO: Break File Parameter above (/b)
  841.  
  842.  
  843.           /S - Subdirectory Copy :
  844.  
  845.                          Format: /s  OR  /s-
  846.                          Use:   Specifying /s tells COPYIT that you wish to
  847.                          copy the files in all of the  subdirectories below
  848.                          the  specified copyfrom subdirectory.  If a  minus
  849.                          sign (-) is directly after the /s COPYIT will copy
  850.                          all of  the files to the target disk and directory
  851.                          that you specified when COPYIT was  executed.   If
  852.                          there is no minus sign, then COPYIT  will "mirror"
  853.                          the subdirectories.  This means  that  all  of the
  854.                          subdirectories below the  specified  copyfrom sub-
  855.                          directory will be created  on  target  disk, below
  856.                          the target directory.  For  example,  if  you have
  857.                          the following directory structure on drive C:
  858.  
  859.                              \──┐
  860.                                 ├──BATLIB
  861.                                 │
  862.                                 └──OLDFILES──┬──BACKUPS
  863.                                              │
  864.                                              └──JUNK
  865.  
  866.  
  867.  
  868.  
  869.                                        - 13 -
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.                          and the following directory structure on drive A:
  880.  
  881.                              \──┐
  882.                                 ├──MYSTUFF
  883.                                 │
  884.                                 └──SAVEIT
  885.  
  886.                          and you executed COPYIT as follows:
  887.  
  888.                               COPYIT c:\oldfiles\*.*  a:\saveit /s
  889.  
  890.                          the final result would be that drive A: would have
  891.                          a directory structure of:
  892.  
  893.                              \──┐
  894.                                 ├──MYSTUFF
  895.                                 │
  896.                                 └──SAVEIT──┬──BACKUPS
  897.                                            │
  898.                                            └──JUNK
  899.  
  900.                          Directory A:\SAVEIT would contain all of the files
  901.                          that   C:\OLDFILES   has,  and   the   directories
  902.                          A:\SAVEIT\BACKUPS,   and    A:\SAVEIT\JUNK   would
  903.                          contain the same files as  C:\OLDFILES\BACKUPS and
  904.                          C:\OLDFILES\JUNK, respectively.
  905.                          It  is  important  to  note  that  if  the  ENTIRE
  906.                          subdirectory  structure  cannot be  "mirrored"  in
  907.                          this fashion onto a single disk, COPYIT will print
  908.                          an error message and halt.
  909.  
  910.                          The second use, with the minus sign,  copies files
  911.                          from    all  of  the  subdirectories  to  a single
  912.                          target.  If the following were entered:
  913.  
  914.                               COPYIT c:\oldfiles\*.* a: /s-
  915.  
  916.                          all  of  the  files  in  directories  C:\OLDFILES,
  917.                          C:\OLDFILES\BACKUPS, and C:\OLDFILES\JUNK would be
  918.                          copied to drive A:  If there is  not  enough space
  919.                          to copy all of the files to a single diskette, you
  920.                          will be prompted for another.  In this case, it is
  921.                          important to note that COPYIT does  not  watch out
  922.                          for identical filenames being overwritten - if the
  923.                          file   XYZ.COM  existed  in  C:\OLDFILES  and   in
  924.                          C:\OLDFILES\JUNK, COPYIT will copy both files.  If
  925.                          both happen to be copied to the same diskette, the
  926.                          second version will overwrite the first.    Use of
  927.                          the /c (check for overlay) parameter will not help
  928.                          - /c only checks that  files  existing  BEFORE the
  929.                          copy operation started are not overlaid.
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.                                        - 14 -
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.           /SYS - System Files :
  947.  
  948.                          Format: /sys
  949.                          Use:  System files, much  like  hidden  files, are
  950.                          normally  ignored  by  COPYIT.    Specifying  this
  951.                          parameter will cause COPYIT to process them.
  952.                          SEE ALSO: Copy Hidden Files Parameter above (/h)
  953.  
  954.                          WARNING: Previous versions  of COPYIT used "/s" to
  955.                          execute this parameter.  Please make  note  of the
  956.                          change.     Entering  /s  performs  a   completely
  957.                          different function.   See "/S - Subdirectory Copy"
  958.                          below.
  959.  
  960.  
  961.           /T - Time Stamp Copied Files :
  962.  
  963.                          Format: /t
  964.                          Use:  When COPYIT copies  files  it  normally does
  965.                          not change  the time/date stamp on the copies.  If
  966.                          the /t parameter is used, the current  system data
  967.                          and time will placed in  the  directory  entry for
  968.                          the file.   The  original files' time and date are
  969.                          never changed.
  970.  
  971.  
  972.           /V - Verify During Copy :
  973.  
  974.                          Format: /v
  975.                          Use:   Specifying this parameter causes COPYIT  to
  976.                          use the standard DOS VERIFY to check each write to
  977.                          the  disk.  This is a  time  consuming  process  -
  978.                          expect COPYIT to take twice  as  long  when  /v is
  979.                          used.  If files  are  simply  being  renamed (this
  980.                          occurs when /m is specified, and  files  are being
  981.                          moved  to different  subdirectories  on  the  same
  982.                          disk), a message is printed and  the  /v parameter
  983.                          is ignored.
  984.                          SEE ALSO: TrueVerify Parameter below (/vt)
  985.  
  986.  
  987.           /VT - True Verify During Copy :
  988.  
  989.                          Format: /vt
  990.                          Use:  This parameter instructs COPYIT to utilize a
  991.                          32  bit Cyclical Redundancy Check (CRC) to  assure
  992.                          that  the  files   were  copied  correctly.    The
  993.                          original file is compared to  the  copy  much more
  994.                          thoroughly  than  normal.     This,  like  the  /v
  995.                          parameter, is time consuming.  If files are simply
  996.                          being renamed, a message is  printed  and  the /vt
  997.                          parameter is ignored.
  998.                          SEE ALSO: Verify Parameter above (/v)
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                        - 15 -
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.           /X - Exclude files :
  1014.                          Format: /x:[mask]
  1015.                          Use:    Earlier,  it  was  explained  how  you can
  1016.                          specify a mask to instruct COPYIT as to what files
  1017.                          it is to copy.  This command allows you to specify
  1018.                          a mask to tell COPYIT what files NOT to copy.   To
  1019.                          use this parameter,  simply enter a COPYIT command
  1020.                          as normal, but  add  the  exclude  command  in the
  1021.                          format shown.   For  example, to copy all files in
  1022.                          the  current subdirectory except for those  ending
  1023.                          with .BAT, simply do the following:
  1024.  
  1025.                                     copyit *.*  a:  /x:*.bat
  1026.  
  1027.                          Up to  five exclude commands can be specified.  As
  1028.                          another example, if you wanted to  copy  all files
  1029.                          in the  current  subdirectory  to  drive  A:,  but
  1030.                          didn't want  to  copy  any  files  with  filenames
  1031.                          beginning with  the letter "C" or "D", or the file
  1032.                          "COMMAND.COM," execute the following:
  1033.  
  1034.                                copyit *.* a: /x:c*.* /x:d*.* /x:command.com
  1035.  
  1036.  
  1037.           /Z - Copy based on File Size :
  1038.  
  1039.                          Format: /z:[nnnn][+-]
  1040.                          Use:  This parameter allows you to specify copying
  1041.                          based upon file size.   The  format  is  as shown,
  1042.                          with [nnnn] equal to  the  file  size to be tested
  1043.                          against (this  can be any integer).  The file size
  1044.                          is then followed  by  either  a  plus  (+) telling
  1045.                          COPYIT to  copy all files equal to or greater than
  1046.                          the file size specified, or a  minus  (-), telling
  1047.                          COPYIT to copy all files equal to or less than the
  1048.                          filesize specified.
  1049.  
  1050.                          For example:
  1051.  
  1052.                                           /z:22000+
  1053.  
  1054.                          would cause all files  equal  to  or  greater than
  1055.                          22000 bytes to be copied, while
  1056.  
  1057.                                           /z:1000000-
  1058.  
  1059.                          specifies that only files equal  to  or  less than
  1060.                          1,000,000 bytes are to be copied.
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.                                        - 16 -
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.           /# - Display Size Information :
  1081.  
  1082.                          Format: /#
  1083.                          Use:   When COPYIT executes, it normally  displays
  1084.                          information on total number of files to  be copied
  1085.                          and  total  bytes  involved,  then begins the copy
  1086.                          operation.   When  this  parameter  is  specified,
  1087.                          COPYIT   will  pause  after  the  information   is
  1088.                          displayed and prompt you as to whether you wish to
  1089.                          continue the copy operation.
  1090.  
  1091.  
  1092.           /^ - Scroll Prompt and Overlay Selections :
  1093.  
  1094.                          Format: /^
  1095.                          Use:   When you specify the  Prompt  (/p)  or  the
  1096.                          Check for Overlay (/c) parameters, COPYIT displays
  1097.                          the filename and  prompts you for information (see
  1098.                          the /p and  /c  descriptions).    After  you enter
  1099.                          information,  COPYIT  displays the  next  filename
  1100.                          over  the  previous  one.   This keeps information
  1101.                          that was on the screen before you  executed COPYIT
  1102.                          from scrolling off  of  the  screen  when  you are
  1103.                          prompted for a  large  number of files.  There are
  1104.                          times, however, when you want the prompt and over-
  1105.                          lay file names  to  scroll, so that you may review
  1106.                          them.  If you  wish  these  filenames to scroll on
  1107.                          your   screen,   instead   of  being  overlaid  by
  1108.                          subsequent file prompts, enter this parameter.
  1109.  
  1110.  
  1111.           /@ - Reset Archive Bit :
  1112.  
  1113.                          Format: /@
  1114.                          Use:  As described under  the  /a  (copy  based on
  1115.                          archive bit) parameter, the archive  bit indicates
  1116.                          whether a file has been created/modified since the
  1117.                          last  backup.  If you want  COPYIT  to  reset  the
  1118.                          archive  bit  on  each  file  it  copies,  the  /@
  1119.                          parameter is used.
  1120.                          SEE ALSO: Copy Based on Archive Bit above (/a)
  1121.  
  1122.                          WARNING:      Most   backup   utilities    perform
  1123.                          incremental backups based upon the settings of the
  1124.                          archive bit.  If  the  archive  bit has been reset
  1125.                          through the use of COPYIT (or any  other utility),
  1126.                          your incremental backups may  not  contain  all of
  1127.                          the  files  that  have been modified/created since
  1128.                          your last backup.
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.                                        - 17 -
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.           EXAMPLES:
  1148.  
  1149.           copyit a:*.*
  1150.           OR
  1151.           copyit a:
  1152.  
  1153.                          Copies all files  in the current directory of
  1154.                          drive A: to the  current  directory  in which
  1155.                          the command was issued.
  1156.  
  1157.           copyit *.* \data /c /p
  1158.  
  1159.                          Copies all files in the  current subdirectory
  1160.                          to  subdirectory  \DATA, prompting  for  each
  1161.                          file copy, and warning if any files  in \DATA
  1162.                          will be overlaid.
  1163.  
  1164.  
  1165.           copyit ABC.TXT HELLO.TXT /m
  1166.  
  1167.                          Since   no  copyfrom  or  copyto  paths   are
  1168.                          specified,  and  move  (/m) is indicated, the
  1169.                          file ABC.TXT is simply renamed to HELLO.TXT.
  1170.  
  1171.  
  1172.           copyit \data\*.bak d:\olddata\*.old /c /m /d:11-1-88 /v
  1173.  
  1174.                          Moves all files  with extensions of .BAK from
  1175.                          directory  \DATA  to drive  D:,  subdirectory
  1176.                          \OLDDATA.  The files' extensions  are renamed
  1177.                          to .OLD,  and  a  warning  is  issued  if any
  1178.                          similarly  named  files  exist  in  \OLDDATA.
  1179.                          Only  files  created  or  last modified on or
  1180.                          after November 1, 1988  are  moved.   Lastly,
  1181.                          each file copy is verified.
  1182.  
  1183.  
  1184.           copyit c:\db\*.* a: /b
  1185.  
  1186.                          Copy all files in C:\DB to drive a:   - if any are
  1187.                          too big to fit  on  a  single diskette, break them
  1188.                          onto many diskettes.
  1189.  
  1190.  
  1191.           copyit a:maildb.dat c:\data /r
  1192.  
  1193.                          Since '/r'  is  specified,  COPYIT  enters Restore
  1194.                          Mode.   The copyfrom extension (.dat) is  ignored,
  1195.                          and COPYIT checks drive A: for  the  first portion
  1196.                          file needed, MAILDB._01       If  this file is not
  1197.                          found,  you  are  prompted  to insert the diskette
  1198.                          containing  it.   Once it  is  found,  restoration
  1199.                          begins.   You  will  be  prompted  whenever  a new
  1200.                          diskette is needed.
  1201.  
  1202.  
  1203.  
  1204.                                        - 18 -
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.           copyit a:maildb.dat c:\data\mail.big /r
  1215.  
  1216.                          This example does exactly the  same  thing  as the
  1217.                          above does,  except the file is restored as a file
  1218.                          named MAIL.BIG
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.                                        - 19 -
  1272.  
  1273.  
  1274.  
  1275.          ----------------end-of-author's-documentation---------------
  1276.  
  1277.                         Software Library Information:
  1278.  
  1279.                    This disk copy provided as a service of
  1280.  
  1281.                         The Public (Software) Library
  1282.  
  1283.          We are not the authors of this program, nor are we associated
  1284.          with the author in any way other than as a distributor of the
  1285.          program in accordance with the author's terms of distribution.
  1286.  
  1287.          Please direct shareware payments and specific questions about
  1288.          this program to the author of the program, whose name appears
  1289.          elsewhere in  this documentation. If you have trouble getting
  1290.          in touch with the author,  we will do whatever we can to help
  1291.          you with your questions. All programs have been tested and do
  1292.          run.  To report problems,  please use the form that is in the
  1293.          file PROBLEM.DOC on many of our disks or in other written for-
  1294.          mat with screen printouts, if possible.  The P(s)L cannot de-
  1295.          bug programs over the telephone.
  1296.  
  1297.          Disks in the P(s)L are updated monthly, so if you did not get
  1298.          this disk  directly from the P(s)L,  you should be aware that
  1299.          the files in this set may no  longer be the current versions.
  1300.  
  1301.          For a copy of the latest monthly software library newsletter
  1302.          and a list of the 2,000+ disks in the library, call or write
  1303.  
  1304.                         The Public (Software) Library
  1305.                               P.O.Box 35705 - F
  1306.                            Houston, TX 77235-5705
  1307.                                (713) 665-7017
  1308.  
  1309.